home *** CD-ROM | disk | FTP | other *** search
/ PC Shareware 1997 February / PC Shareware 1997-02.iso / programy / envlp122 / notes.txt < prev    next >
Text File  |  1996-03-15  |  24KB  |  498 lines
  1. This file contains the most up-to-date information about changes to
  2. the current and previous Envelop releases. Each release has its own
  3. section, with the most recent at the top of the file. Envelop releases
  4. are made approximately one per month, or more frequently as needed.
  5.  
  6. ==============================================================================
  7. NOTE: Because Envelop Engine relies on registry entries that are made
  8.       at install time, different versions of Envelop Engine will not
  9.       run simultaneously at this time. For example, if you install version
  10.       1.2 in a different directory, but on the same computer as 1.1 is
  11.       installed, then the 1.1 version will no longer operate correctly,
  12.       unless the registry entries are returned to the correct state for
  13.       version 1.1. Each version of Envelop Engine includes a file,
  14.       envelop.reg, which contains the correct registry entries for that
  15.       release. To install the correct registry entries for a particular
  16.       version of Envelop Engine, double-click on the .REG file for that
  17.       release (using Explorer or File Manager), or run the command:
  18.         C:\ENVELOP\PROGRAM> REGEDIT ENVELOP.REG
  19.       from a DOS prompt, with current directory set to the appropriate
  20.       PROGRAM directory for the release you wish to run.
  21. ==============================================================================
  22.  
  23. ENVELOP ENGINE RELEASE HISTORY
  24.  
  25.         Release 1.2.2
  26.     
  27.         CHANGES SINCE PREVIOUS RELEASE:
  28.     
  29.     - Several new tutorials have been added to the online documentation:
  30.       including menu editor, Ocx, TabStrip, ListView, and database tutorials.
  31.     
  32.     - The SystemTools object is now documented. It provides the RunProgram
  33.       methods for executing other programs from Envelop applications.
  34.     
  35.     - A glossary of terms has been added to the online documentation.
  36.     
  37.     - ODBC object now ignores inaccessible tables (prevented easy connection
  38.       to MS Access databases)
  39.     
  40.     - ODBC now formats table names internally within quotes
  41.       so table names containing whitespace work properly.
  42.     
  43.     - ODBC properties TableName, FieldName, DriverName, and DataSourceName
  44.       are now read-write properties (formerly read-only).
  45.     
  46.     - ODBC TableIndex, FieldIndex, DriverIndex, and DataSourceIndex properties
  47.       are now reset to zero when appropriate to avoid invalid index values.
  48.     
  49.     - Fixed ValueData method for ODBC source so it can retrieve more than 1K
  50.       of data and so it returns correct retrieved data size.
  51.     
  52.     - Fixed bugs in TabStripTab and ColumnHeader Caption properties.
  53.     
  54.     - Several enhancements and fixes to the DataControl Configuration Wizard.
  55.     
  56.     - ObjectViewer now uses left-mouse button to drag objects (to the Controls
  57.       palette, for example).
  58.     
  59.     - ObjectViewer's Project view no longer auto-selects the currently-selected
  60.       object when switching to the project view. This avoids the annoying
  61.       expansion of module items in the project view. The other views still
  62.       auto-select to assist in locating an object's module or place in the
  63.       inheritance hierarchy.
  64.     
  65.         ==============================================================================
  66.  
  67.         Release 1.2.1
  68.     
  69.         CHANGES SINCE PREVIOUS RELEASE:
  70.     
  71.     - Fixed a problem with OCX objects under Windows 95 that prevented
  72.       arguments to OCX methods and events from being recognized.
  73.     
  74.     - OCX controls now initialize the OCX members when the OCXClassName
  75.       property is set.
  76.     
  77.     - Fixed a bug in copying of initialized OCX objects.
  78.     
  79.     - Fixed a bug in loading of controls from binary modules (EBOs) that
  80.       caused problems when the control had a DataSource.
  81.     
  82.     - Fixed uninitialized data problem in UpdateDataSource event.
  83.     
  84.     - Fixed a caching bug that caused stale array reference after redim.
  85.     
  86.         ==============================================================================
  87.  
  88.         Release 1.2
  89.     
  90.         CHANGES SINCE PREVIOUS RELEASE:
  91.  
  92.     NOTE: Envelop Engine 1.2 now requires Windows NT version 3.51,
  93.           or Windows 95 to install and run.
  94.  
  95.     - Online help file has been upgraded to new Windows 95 style help file.
  96.  
  97.     - Implemented product uninstall support for Envelop Engine.
  98.  
  99.     - Interpreter performance has been enhanced by adding a member lookup cache,
  100.       and by several smaller optimizations.
  101.  
  102.     - Preliminary implementation of new common controls objects: RichTextBox,
  103.       ListView, TabStrip, ImageList, and support objects: ListItem, ColumnHeader,
  104.       and TabStripTab.
  105.  
  106.     - Implemented new menu editor.  Graphical, indented-list style editor,
  107.       simplifies the menu editing process.  Built as an interpretive object: MenuEdit.
  108.  
  109.     - Preliminary support for OCX controls.
  110.  
  111.     - Removed support for VBX controls. VBX support was limited to VBX 1.0 only, under
  112.       Windows NT only. VBX support removed in favor of focusing on OCX support.
  113.  
  114.     - The Configure DataControl Wizard has new functionality to create, layout, and
  115.       modify a set of controls on the form that correspond to fields in a database table.
  116.       This is a preliminary implementation of this functionality that we will continue
  117.       to refine to make DataControls and associated controls easier to work with.
  118.  
  119.     - Object references can now be passed as by-reference arguments. This change can
  120.       cause new side effects for existing code, since the default prior to this release
  121.       was to pass object references as ByVal, and specifying ByVal for object reference
  122.       parameters was illegal. For example, suppose an object has the following methods:
  123.  
  124.         Sub doit(o As Object)
  125.           o = Nothing
  126.         End Sub
  127.  
  128.         Sub go
  129.           Dim ref As Object
  130.           ref = Me
  131.           doit(ref)
  132.           Debug.Print ref
  133.         End Sub
  134.  
  135.       Prior to release 1.2, when go() was invoked, it would have printed Me (whoever
  136.       I am) to the Debug window. As of release 1.2, the same method will print a
  137.       blank line, since the object reference "ref" will be modified by the doit()
  138.       method. If a new side effect is introduced, it can be corrected by modifying
  139.       the parameter definition, as in:
  140.  
  141.         Sub doit(ByVal o As Object)
  142.           o = Nothing
  143.         End Sub
  144.  
  145.       which returns doit() to the state of having no effect on the "ref" argument.
  146.       We decided the risk of new side effects in existing code was worth fixing
  147.       the old behavior, since before the only way of getting an object from a
  148.       method was by the return value. Now in-out or out-only parameters can be
  149.       used to receive objects from a subroutine or function. In the Envelop code,
  150.       approximately 10,000 lines of Basic, we had two undesirable side effects
  151.       that required fixing because of this change.
  152.  
  153.     - A new mechanism is in place to help recover objects from a module that
  154.       cannot load properly because prerequisite objects can't be found or no
  155.       longer match the dependent objects in the module. This situation is known
  156.       as a proxy-resolve failure, and can occur when a base object (a source
  157.       for some derived, or copied object) has been modified outside the presence
  158.       of the dependent object, or has been destroyed outside the presence of the
  159.       dependent object, or simply is not yet loaded when the dependent is loaded.
  160.       Now when a module experiences a proxy-resolve failure, a new object is created
  161.       to meet the proxy-resolve needs of the dependent object, and the object is
  162.       allowed to load as a child of the new proxy object. This can help to recover
  163.       work that could have been lost under revisions prior to 1.2.
  164.  
  165.     - The window layout methods have been improved to scale the layout information
  166.       so they work better for various display settings. Also, a "New" button was
  167.       added to the Options|Window Layouts dialog to make it clearer to the user
  168.       that new custom layouts can be created and saved. A toolbar button was added
  169.       to the main toolbar to restore the default layout (on click) and display the
  170.       window layouts dialog (on double-click).
  171.  
  172.     - If the Object Viewer has keyboard focus, and a module or project is the
  173.       selected item in the current view, then the operation attempted on a DEL
  174.           keypress is either a project close or module unload as appropriate. Prior
  175.           to 1.2 the action on DEL key was always to attempt destroying the selected
  176.       object when the Object Viewer received the DEL key.
  177.  
  178.     - Reduced dependencies on the database DLLs so that non-database apps should
  179.       be able to ship with fewer runtime files required.
  180.  
  181.         - Changed which properties of a Window that the Update and UpdateDataSource
  182.           methods interact with.  Previously, the "Text" property was used when
  183.           updating to/from the Windows DataSource. Now the "Caption" property
  184.           is used for most objects, while the "Value" property is used for the CheckBox,
  185.           Gauge, OptionButton, and ScrollBar objects, and the "ListIndex" property
  186.           is used for the ListBox object.
  187.  
  188.     - For the enumerated type, OleDropState, switched the values of Leave and Enter (they
  189.       were incorrectly transposed before).
  190.  
  191.     - Fixed problems with Envelop's help window being closed when other
  192.       applications or other help windows were closed.
  193.  
  194.     - For ObjectTools, added the method, GetEnumStrings, which will return a
  195.       string containing the strings for all the values of an enumerated type.
  196.  
  197.     - Fixed problems with empty 'Set' being written to .eto files for procedural properties.
  198.  
  199.  
  200.         ==============================================================================
  201.  
  202.         Release 1.1
  203.  
  204.         CHANGES SINCE PREVIOUS RELEASE:
  205.  
  206.         - Improved memory performance, including fixing a serious leak that under Win95
  207.           was most noticeable when interacting with the help file.
  208.  
  209.         - Added startup dialog and options to allow easy configuration of Envelop's startup
  210.           behavior (make automatic new project, browse to open a project, no project, etc.).
  211.           The "out-of-the-box" behavior is still to make an automatic new project, but the user
  212.           can now change this using the Options|Startup dialog.
  213.  
  214.         - Improved the DataControl configuration wizard:
  215.            o don't have drag/drop set the object's DataSource.
  216.            o have Add button set the DataSource
  217.            o clear controls list before population
  218.            o use full names when populating controls list
  219.  
  220.         - Multi-select support has been added to ListBox, FileListBox, and IndentedList.
  221.  
  222.         - Added support for: For Each x {In | CopiedFrom | EmbeddedIn}...Next x
  223.           This language feature allows easy iteration of objects in a group, objects
  224.           embedded in a host object, and objects copied from a prototype object.
  225.  
  226.         - Options|Window Layouts now saves visibility of Property, Method, and Debug windows.
  227.  
  228.         - Envelop's project and module file dialogs now retain the last directory visited,
  229.           still without changing Envelop's current directory.
  230.  
  231.         - Added Center method on Form for centering Form in the middle of screen.
  232.  
  233.         - Added [Set]ItemText{Style|Color} methods to IndentedList. Allows color,
  234.           bold, italic, and bold-italic in list item text.
  235.  
  236.         - Improved error reporting under Win95.
  237.  
  238.         - When the debugger is not present, or is not trapping system exceptions, the error
  239.           box now also displays the object and method name responsible for the error.
  240.  
  241.         - Added event locale button on Method Editor for easy specification/navigation
  242.           of event-handling methods located on an embedded object or its container.
  243.  
  244.         - Method editor now creates initial get/set methods for Procedural Properties.
  245.  
  246.         - Added a vertical sash to the Property Editor's list of properties, so the user
  247.           can adjust the relative widths of the property name and value columns.
  248.  
  249.         - Added TextStyle and TextColor properties to PropertyEditor.
  250.  
  251.         - The Preload event is now supported simply by adding a Preload method to
  252.           any object. Preload events are sent as soon as the object's module is loaded.
  253.  
  254.         - Under Win95, the OpenDialog and SaveAsDialog objects now use the Explorer-
  255.           style common dialogs.
  256.  
  257.         - For Win95, Envelop now goes into taskbar properly when minimized.
  258.  
  259.         - Form.Caption is now kept in sync with object name on renames, when the caption
  260.           is the same as the old object name.
  261.  
  262.         - New forms now take their initial position from Form, and Form is
  263.           included in default layouts so new forms are in a nice initial place.
  264.  
  265.         - Upload Wizards are now shipped with the release and have been improved
  266.           to allow you to retrieve the entire contents of a directory.
  267.  
  268.         - Fixed a bug with Text object's ParagraphDelimiterExpr property.
  269.  
  270.         - Fixed a bug where our gadget icons did not look right when user interface
  271.           color scheme was changed.
  272.  
  273.         - Fixed problem with CreateDataSource method, list of data
  274.           sources is now accurate.
  275.  
  276.         - Fixed bugs in processing of "Connect" string,
  277.           also fixes other parsing related bugs. Affects ODBC object.
  278.  
  279.         - Fix problems with mouse capture not being released under Win95.
  280.  
  281.         - Fixed errors with line number reporting for exceptions.
  282.  
  283.         - Added GetSysColor and constants to User32.
  284.  
  285.         - Added SearchPath declare to Kernel32.
  286.  
  287.         - Published FullPathName and ShortPathName properties on Directory and File objects.
  288.  
  289.         - Added RunProgramGetStatus to SystemTools object.
  290.  
  291.         - Support for enhanced metafiles in printing and XferData Pictures.
  292.  
  293.         - Support for HintText event on button gadgets.
  294.  
  295.         - Improved the NewProjectForm with a resize method and auto-selection
  296.           of the .EXE file to match the .EPJ file dir/name.
  297.  
  298.         - Fixed bugs involving setting certain properties within an object's
  299.           Setup method.
  300.  
  301.         - Fixed a small bug in Name getting that caused the File object 
  302.           properties Path & Name & Extension to not give the correct full path
  303.           name back if the name part is a long name with multiple dots (.) in it.
  304.  
  305.  
  306.         ==============================================================================
  307.  
  308.         Release 1.0.3
  309.  
  310.         CHANGES SINCE PREVIOUS RELEASE:
  311.  
  312.         - Fixed a bug that caused a program error when closing projects with
  313.           a certain common pattern of interdependencies.
  314.  
  315.         - Fixed reporting of line numbers when an error occurs in a method
  316.           invoked from a Begin Code..End Code section of a text module.
  317.  
  318.         - Samples Browser now properly advances to partially-matched search string.
  319.  
  320.         - A couple of small fixes to the Wizard implementation objects.
  321.  
  322.         - The InstallButton has been revised to support a more robust component
  323.           installation model.
  324.  
  325.         - The object operations: Copy, Abstract, and Save To Text now tell which
  326.           object is being operated on.
  327.  
  328.         - The HostObject method was modified to not cause a program error when
  329.           invoked with Nothing as an argument.
  330.  
  331.         - The IsPreload method now correctly returns True/False instead of 1/0.
  332.  
  333.  
  334.         ==============================================================================
  335.  
  336.         Release 1.0.2
  337.  
  338.         CHANGES SINCE PREVIOUS RELEASE:
  339.  
  340.         - Envelop now searches directories in the following order for modules
  341.           when no explicit path information is given with the module load request:
  342.             1) The directory the application was loaded from.
  343.             2) Current directory.
  344.             3) 32-bit system directory (GetSystemDirectory).
  345.             4) 16-bit system directory (no API to get this).
  346.             5) Windows directory (GetWindowsDirectory).
  347.             6) Directories given in PATH.
  348.             7) Directories given in ENVELOP_PATH (if defined).
  349.           As you add modules to projects, Envelop adds the directory containing
  350.           the module to the ENVELOP_PATH (if it is not there already). In general,
  351.           this makes it possible to find modules without explicit path information,
  352.           and makes it easier to reorganize your projects by moving or renaming the
  353.           directories that contain them. If the ONLY way to load the proper module
  354.           is to keep explicit path information, then the full path to the module
  355.           will be stored in the Envelop project file (.EPJ file). You can edit this
  356.           file with any text editor if you must move the project or the module to a
  357.           different location.
  358.  
  359.         - Envelop .EXE files are now written with NO explicit path information
  360.           with regard to module locations. This makes it easier to install an
  361.           Envelop application in a location different from where it was developed.
  362.           It also means that for an application to load properly, all its modules
  363.           must be findable via the standard module search sequence (see above).
  364.  
  365.         - Support has been implemented for the following standard screen resolutions:
  366.           1024x768, 800x600, and 640x480. You can also create your own layouts and
  367.           save them, using the "Options|Window Layouts..." menu item from the Envelop
  368.           main form. The screen layout support is implemented in a generic way that
  369.           you can use in your own applications by using the following objects:
  370.           ScreenLayoutSet, ScreenLayoutConfigForm, ScreenLayout, and WindowLayoutItem
  371.           (all in module "tools"). These objects are not yet documented.
  372.  
  373.         - The following methods were implemented (mainly to support the screen
  374.           layout implementation):
  375.             o Screen.EnumWindows
  376.             o ObjectTools.EnumObjectCopies
  377.             o ObjectTools.EnumObjectEmbeds
  378.             o ObjectTools.FindObjectFromWindow
  379.           These methods are not yet documented; see the code that implements the
  380.           screen layout support for examples of how to use them.
  381.  
  382.         - The objects HashStringString and HashStringObject were added. These
  383.           objects are similar to the HashDictionary object (which is used to
  384.           implement Envelop's context-sensitive help). Hash tables are an
  385.           efficient way to search for an item using a "hash-function" over
  386.           a string to quickly reduce the search to a small subset of the items
  387.           in the table. The three different kinds of tables are all indexed
  388.           by a string, but each stores a different kind of item as the value
  389.           associated with the key string:
  390.             o HashDictionary:   key=string, value=long
  391.             o HashStringString: key=string, value=string
  392.             o HashStringObject: key=string, value=object
  393.  
  394.         - The management of message loops by modal forms and the debugger was
  395.           improved to avoid inteference between them that could put the system
  396.           into a confused state.
  397.  
  398.         - Prior to version 1.0.2, if a modal form was going to both hide and
  399.           return a specific modal result, the sequence of function calls had
  400.           to be "Hide" followed by "ModalResult(result)". Now either order of
  401.           these function calls results in the proper behavior, i.e. the form is
  402.           hidden and the result given to ModalResult is returned from ShowModal.
  403.  
  404.         - The following new samples were added:
  405.            o bootcamp\basic\dbconect
  406.            o bootcamp\advanced\dbsample
  407.            o arsenal\parts\grid
  408.  
  409.         - Bugs were fixed in drawing filled shapes in certain Drawable controls,
  410.           in the object list and hierarchy controls, in deleting the top-visible
  411.           property from the Property Editor, in the Call Stack trace window, and
  412.           in moving objects between modules.
  413.  
  414.         - Much more documentation has been added, including an expanded tour of the
  415.           main windows in the Envelop environment, and more documentation of the
  416.           samples provided with Envelop.
  417.  
  418.  
  419.         ==============================================================================
  420.  
  421.         Release 1.0.1
  422.  
  423.         CHANGES SINCE PREVIOUS RELEASE:
  424.  
  425.         - The Envelop setup program now makes every attempt possible to get the
  426.           Envelop program directory into the user's path. This helps avoid trouble
  427.           due to a problem with OLE under Windows NT that causes an error during
  428.           startup of Envelop. It also makes it easier to run Envelop applications
  429.           created during tutorials, without having to further modify the user's
  430.           environment.
  431.  
  432.         - The Finger and Help-Finger are now more careful about ignoring windows
  433.           from other programs, which previously caused occasional errors.
  434.  
  435.         - Many improvements have been made to the samples (bootcamp and arsenal)
  436.           and the Envelop Help file.
  437.  
  438.         - Fixes were put in to keep the Vbx and GL controls from causing program
  439.           exceptions when used under Windows95.
  440.  
  441.         - The Ole control sample had a problem under Windows95 that has been fixed.
  442.  
  443.         - The handling has been improved for when the DLL for an Object can't be found.
  444.  
  445.         - Loading Help files from samples under Windows95 has been fixed.
  446.  
  447.         - Providing no arguments to a method that takes arguments is now handled correctly.
  448.  
  449.  
  450.         ==============================================================================
  451.  
  452.         Release 1.0
  453.  
  454.         CHANGES SINCE PREVIOUS RELEASE:
  455.  
  456.         - Envelop now supports managing multiple object modules using a Project
  457.           metaphor. Projects can be either application projects which are targeted
  458.           toward developing a standalone EXE, or component library projects which
  459.           are targeted toward developing a set of re-usable objects. On startup a
  460.           new application project is automatically created with its main form ready
  461.           for editing.
  462.  
  463.         - Unloading of modules required by other modules is now restricted. A module
  464.           "B" requires module "A" when "B" contains objects that were copied from some
  465.           object in "A". Object references between modules do not by themselves
  466.           restrict unloading modules, but if a module "C" contains an object with a
  467.           reference to some object in module "D", and "D" is unloaded, the reference
  468.           in "C" becomes an empty reference (is set to "Nothing").
  469.  
  470.         - When an object is destroyed, all embedded objects of that type are now removed,
  471.           the old method was to leave a "null" object in the embedded object's place.
  472.  
  473.         - Context sensitive help is now in place.  The 'F1' key is recognized by all
  474.           object editors (e.g. Method Editor, Property Editor, Object Viewer), and in 
  475.           various other places.  The Help icon now acts like the Finger icon, to select
  476.           a specific object interactively to get help on.
  477.  
  478.         - Embedding controls from the PropertyEditor onto the "edited" form is no longer
  479.           a problem.
  480.  
  481.         - Event DblClick is now declared on the Ole control.
  482.  
  483.         - When Envelop starts up, the main window now has focus.
  484.  
  485.         - Thumb dragging a Scrollbar into a negative value is no longer a problem.
  486.  
  487.         - New HashDictionary object available, that associates a string to a number
  488.  
  489.         - File type is checked on FileName specified for a resource file in Bitmap,
  490.           to avoid alarming (but harmless) system error message.
  491.  
  492.         - All problems relating to Text object and the first line of text, and
  493.           end-of-line problems have been fixed.
  494.  
  495.         - Dynasets with DelimitedAscii or FixedAscii databases now behave properly
  496.           when FirstLineAsFieldNames is True, under the Update method.
  497.  
  498.